Technical Report 

Writing 



Lecture (4) 

By 

Dr.Eng/ Hagar Aim El Din 




Technical writing can be characterized 

as follows 

(Book Page 6) 



Technical writing deals with technical 
information. 

Technical writing relies heavily on visuals 

Technical writing uses numerical data to 
precisely describe quantity and direction. 

Technical writing is accurate and well 
documented . 

Technical writing is grammatically and 
stylistically correct. 



Key features of reports 

(Book Page 14) 



Designed for quick and easy 
communication of information 

Designed for selective reading 

Use sections with numbered headings 
and subheadings 

Use figures and diagrams to convey data. 



Basic structures of reports 

(Book Page 14-15) 
Lecture (3) 
Important 



Title Page 
Summary 
Table of contents 
Introduction 




Body of the report (Middle sections) 
Conclusions 
References. 
Appendices. 





No report is perfect, and definitely 
not on the first version. 

Well written reports are those have 
gone through multiple rounds of 
refinements. 

Refinements can be self-reading and 
critical analysis, or more effectively 
by peer reviewer . 




Feed back of reports 

(Book Page 18) 




Checks if the title/abstract makes sense are 



effective/eye-catching. 

Are all the relevant questions answered in the 
introduction ? 

Is the overall structure of the rest of the sections 
meaningful? 

Is the difference from related/past work crisp and 
meaningful? 

Are the technical sections understandable? 




Feed back of reports 

(Book Page 18) 




Are the figures/tables explained properly? 

Are the symbols used defined appropriately? 

Are the results explained properly? 

Are the conclusions drawn from the 
graphs/tables sound? 

Do the results show how the work presented 
is better/worse that the other cases of 



comparison 
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Different Types of Technical Reports 
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Proposals 



Laboratory and 
Project Reports 




Feasibility and 
Recommendation 
Reports 



Progress 
Report 




(1) Proposals 



Proposals are among the most important 
documents one can write. 

Persons and organizations that write effective 
proposals win grants, contracts, and jobs; 
persons and organizations that do not write 
effective proposals often just wind up " going 
away" — sometimes "far away/ 1 
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(1) Proposals 



are specialized, technical 
business documents that offer 

{able to 

persuade/convincing) solutions to 
problems 



also needs to sell the 
reader on some idea — usually that he 
or she (or his or her organization) 
needs specific goods or services that 
you (or your organization) can provide. 
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\ To be successful , you normally need to do at least 
three things in any proposal you write: 



4 



1- Describe, identify, or refer to a problem that needs 
to be solved, (add description for the problem to let 
the reader know you understand the problem) 




2- Offer a viable solution to the problem 
(you have to demonstrate that your proposal 
solve the problem effectively) 




3- Show that you can effectively implement this solution 
(you must show that you have skills and resources to do 
what you prposing) 




Difference between Form 



Formal proposals are normally 
large, comprehensive documents 
produced by a team of experts on 
behalf of an organization. 



An executive summary , A technical 
volume (solution) , A management 
volume(persons) A cost volume, A • 
resources volume(HR, PR) 

Formal proposals is a difficult type 
of proposals to write. Evaluated in 
competitive environment • 



and Informal Proposals 



Informal proposals are generally 
short documents of limited scope 
written by an individuals ,not 
teams. 

Informal proposals take the form of 
a long letter or short document) 

Informal proposals also may be 
either solicited {make requests) or 
unsolicited 

With solicited proposal ,responds to 
a specific request, the problem has 
already been identified, and the 
decision to solve the problem has 
already been made. 
Unsolicited proposals often come 
from within an organization, no one 
asked for 3 
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• Have I defined the problem in great enough detail to 
ensure that my readers will understand the context 
for this proposal? 

• Have I described the background for this problem in 
great enough detail to clearly identify the variables 
driving my proposed solution? 

• Have I defined in the scope section how I am 
limiting my proposal? 

• Have I laid out my proposed solution in adequate 
detail? 

• Do I have enough details to ensure that my solution 
is credible? 

• Is my time estimate consistent with the tasks in my 
statement of work? 



Ill 







(2) Progress Report 



Progress reports document the status of a project. 
Describe the various tasks that make up the 
project and analyze the progress that has been 
made toward completing each task. 



Generally speaking, in a progress report you need 
to tell the reader three things: 
The problem you are solving, 
The solution you are implementing, 
How well you are doing 



Writing a progress report typically requires that you 
do three things: 

Page(29) 
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Progress Reports Outline 



ntroduction 

Purpose 

• Problem 

• Scope 
Background 

Theory 

• Research 

Test and Evaluation 

• Apparatus 
Procedure 

Findings 

• Data 

• Interpretation 

Conclusion 

• Assessment 

• Recommendations 



Describe the reason for writing this report. 
Describe the context for this report, including 
project requirements. 
Describe the limitations of this report. 

Review the theoretical basis for responding to 
requirements. 

Review prior research relevant to requirements. 

Describe device(s) used to accomplish the task. 
Describe procedure(s) used to accomplish the 
task. 

Review the results of the test and evaluation. 
Provide your interpretation of the results, that 
is, to what extent requirements were met. 

State your conclusions based on the interprets- 
tion(s). 

Provide your recommendation(s), if any. 



Progress Report Checklist 



• Have I specified the purpose, 
background, and scope of this report? 



proposal by name, number, and/or 
date? 



Have I reviewed the problem contained 
in that proposal? 



the proposed solution 



Have I specified the tasks that will be 
included in this report? 




ussed the tasks 
completed and tasks remaining? 
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(3) Feasibility and Recommendation 

Reports 
Book Page 31,33 I 



Feasibility reports and recommendation reports 

Are objective documents that identify and evaluate 
solutions to problems. 



These reports address subjects 
that have well-defined 
parameters , including a problem , 
or multiple problems, that can be 
precisely described; and a 
solution , or multiple solutions, 
that can be objectively and 
empirically tested . c 



Both 



commendation 




make statements 
about what should 
be taken to solve a 
problem, resolve a 
dilemma, or undertake a 
ourse of action 





i 


j Feasibility reports and recommendation reports 1 
1 Are H 
Frequently their conclusions and recommendations H 
' can be used to sell ideas or goods. 1 










Preparing a Recommendation Report 






• Start with an introduction/Summary 

• Determine audience and purpose 

• Describe the situation 

• Define the requirements 

• List and describe options 

• Include any necessary background 

• Write a point-by-point comparison 

• Clearly state the conclusion(s) and 
recommendation(s) 
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Feasibility report 




consider a single solution 
to a problem and determine whether or not, 
r to what extent, the proposed solution i 



feasible 



ndation re 



, on the other hand 




look at several approaches for solving a 
problem and recommend the most feasible 
approach. 

Recommendation reports are written before a 
decision is reached. Feasibility studies , by 
contrast, seem often written to assure decision- 
makers that their initial decisions are workable 
and sound. 





A recommendation report is written when 
several courses of action seem possible, while 
a feasibility report is done after a tentative 
decision has been reached. 




it. 
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Writing Feasibility and Recommendation Reports 



Define a problem that needs to be solved. 

Identify one or more candidate solutions. 

Develop a set of criteria by which to objectively 

evaluate the candidate solution(s). 

Collect and interpret data for each criterion as it 

relates to each candidate solution. 

Draw conclusions and make recommendations 

regarding the feasibility of the candidate solutions 

based on your interpretations 




Importatnt Links 



http://www.uazone.org/friends/esl4rus/libr/writing/feasxl.html 
http://wps.pearsoncustom.com/pls 1256647969 pwo/217/55690/1 
4256666.cw/index.html 



■ 




• Have I explained all criteria, including why they were 
selected and how much weight each is being given? 

• For all criteria, have I collected information (data) that 
is objective and meaningful? 

• Have I provided useful interpretations of this (these 
data)? 

• Have I included a conclusion based on these 
interpretations? 

• Have I made a recommendation based on this 
conclusion? 

• Have I included a contact who can provide more 
information about this report? 

• Have I documented the sources I used for my 
information? 

• Have I included any necessary supporting information in 
an appendix? 



(4) Laboratory and Project 

Reports 
Book Page 38,39 



These documents present information that relates to 
the controlled testing of a hypothesis, theory, or device 
using test equipment (the apparatus) and a specified 
series of steps employed to perform the test (the 
procedure). 



Prese 
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laboratory reports are research 
oriented documents, meaning that 
they start with theory that needs to be 
applied and tested under highly 
controlled conditions. 



The laboratory outline p rovides a model for a 
£ research-oriented laboratory report. 

The project outline provides a slightly different 
model for the kind of project report frequently 
required as part of a teaching laboratory . 
The goal of the project report to demonstrate the 
application of a theory by using available technology. 




In our example page 38, (laboratory outline) 
will be used to develop a research laboratory 
report. Following that, project outline will be 
used to produce a project report 
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Have I clearly defined the purpose of this 
report? 

Have I clearly described the problem that 
requires this report? 

Have I clearly explained the limitations of 
this report? 

Have I discussed any theory necessary for 
the reader to understand the report? I 
Have I reviewed relevant prior research? 
Have I described the apparatus I used to 
collect the data? 

Have I described the procedure I used to 
collect the data? 
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(5) Research Reports 

Page 41 



Research reports are similar to research papers that 
every student has done at one time or another. In 
technical writing, however, research reports are 
focused, objective inquiries into technical subjects. 



Presenter Media 
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Research reports describe the discovery, analysis, 
and documentation of knowledge obtained 
through some type of investigation 

M 

rch reports 



are specifically geared to the 
purpose at hand, the readers who will use them, the 
clients who will read them, and whatever limitations 
have been placed on the scope of the project 



mimical Research reports focus on new technologies 
investigation, are called mBBffmBTMB^ 
^search reports focus on past technology are called 



historical reports. 



j 
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Research Report Checklist 



Have I clearly stated the purpose of this report? 
Have I introduced the topic with a brief overview of 
the problem or background? 
Have I discussed how I limited the report and my 
rationale for doing so? 

Have I provided adequate background for my 

reader to understand the report? 

Have I provided substantive, well-documented 

information in the report? 

Have I included necessary visuals and data? 

Have I summarized my research in the conclusion? 
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Technical Report summary: 

What does report contain? 
Purpose-scope-major issues- 
main conclusion. 
1 page or less 





Scientific Report abstract: 
Investigation of report-Problem 
main result- main conclusions. 
200 words or less H 
condensed 



Summary: 

Should outline all the features of your report, 
including topic, what you did, how you did it, 
and the main outcomes from your work. 

Summary does not have 

• Background information 

• why you are doing your research 

• refer to diagrams or references 



KEEP 
CALM 

AND 

DO YOUR 
HOMEWORK 



Homework 



Summarize the difference between 



Progress report. 
Proposal. 

Laboratory report. 
Recommendation report. 
Feasibility report. 
Project report. 




